INSTRUCTIONS FOR USING THE VOICE BOX 


IF YOU HAVE A DISK DRIVE: 


* Plug the voice box into the Disk Drive . 

* Switch-on the power using your own DOS Waster Disk, 
and Basic cartridge. 

* Put in the Alien Disk. 

* If you have 16K memory, type RUN n D:Vb 

* If you have 32K memory or more, type RUN "DsVBRF 

* Follow the prompts . 

IF YOU HAVE A PROGRAM RECORDER " 


Insert the cassette the right way up according to 
the amount of ram you have, rewinding it if necessary. 
Plug in your Basic cartridge - 

Type CLOAD, hit return and start the recorder, hit 
return again. 

Type RUN. 

Follow the prompts. 


IF ALL ELSE FAILS, READ THE INSTRUCTIONS . 

WHAT IT DOES 


The voice box plugs into the serial port of an 
Atari 400 or 800 computer, and translates computer codes 
into speech. 

The sound comes out of the TV speaker. The computer 
codes must originate as text strings in a Basic program . 

The programs supplied with the Voice Box translate 
English text into the phonetic codes which constitute its 
native tongue and also allow you to teach it to pronounce 
words such as names which it did not know before. The 
programs have menus and prompts to help you store the 
prqnunciation dictionaries on disk or tape. If your 
computer has 32X or more memroy then you can also try 
the random sentence generator, which speaks simple 
grammatical sentences using words you can choose, and you 
can run the version which incorporates the talking face, 
which provides some lip-sync animation. 



Instructions are given in a later section which 
should help you incorporate the voice box in other basic 
programs. 

HOW TO LOAD THE PROGRAM 


If you are reading this then you have probably 
already tried to run the program and something went wrong, 
most likely because the program was too big for your 
machine's memory. 

CASSETTE SYSTEMS 


There are two versions, one for computers with 16K 
of memory and one for 32K or more. The smaller version 
does not incorporate the random sentence generator or.the 
face. Both versions start at the very beginning of the tape 
but on opposite sides. 

THE 16K VERSION After loading the program, type RUN. 
After a few moments a prompt will appear inviting you to 
set up the cassette with the pronunciation dictionary. The 
dictionary supplied is the next file on the tape so you can 
just type D return. If, later on, you add to the dictionary 
you would at this point insert the cassette with your 
dictionary, and type D return. One other alternative is to 
type P return. This tells the program to use the bare 
phonetic dictionary that was already loaded along with 
program. 


After the dictionary is loaded the program will tell 
you to unplug the program recorder and plug in the voice box. 
You can then type in sentences and have the machine speak 
them. 


CASSETTE VERSION FOR 32K OR MORE The loading 
proceedure is identical to that for the 16 K version until 
you come to try the random sentence generator. This requires 
that you load a file containing the words to be used in the 
sentences. The next file after the pronunciation dictionary 
will do to start. You will be able to alter the words.-.and 
add your own, but you must begin with some words of each 

type. 
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OTHER POINTS FOR TAPE USERS 


The cassette su pplied is write protected so if you 
want to use it to save dictionaries or random word lists 
you must first stick tape over the protect tab holes. 

A bug in the Atari operating system (still unfixed 
as of March 1982) requires that you type LPR. before doing a 
save. This causes an error message which you should ignore. 
If you want to modify or copy the program you must remember 
to do this. 

INSTRUCTION’S FOR USERS WHO HAVE A DISK DRIVE 


Power up your system in the usual way with an Atari 
disk that contains DOS . 

Insert the Alien Disc and type run "D:VB. If you 
have 32K or more type run " D:VBRF after a short time the 
program will respond by asking you to specify which 
dictionary. you should type a number from 1 to 3 to use 
one of the supplied dictionaries, or you may hit return to 
use the basic phonetic codes already loaded along with the 
program. You would do this if you wanted to construct a 
new dictionary from scratch. 

AFTER THE DICTIONARY IS LOADED A message will tell 
you to plug in the voice box and hit return. The voice box 
connects to the disk drive or the interface box. 

If all is well a list of options should appear on the 
screen and you should hear the plea "PLEASE TEACH ME TO SPEAK" 
or "YBBS MAHSTBR" this is an example of the phonetic spelling 
into which everything must be translated for the voice box 
to speak. This translation task can be done by the computer 
using one of the dictionaries . 

HOW TO BUILD UP YOUR OWN DICTIONARY 


Simply type the phonetic spelling followed by - and 
the proper spelling. For EXAMPLE: SPEK^SPEAK. You will 
probably see that the computers memory will soon be 
exhausted since each word must take about ten bytes. The 
trick is to enter word fragments. or INSTANCE: BK^EAK 
teaches the program several words: SPEAKt PEAK, LEAK TEAK 
and probably many more. One might go a step further and 
enter: B-EA since this is the general case. Exceptions 
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such as the word 'PEAR‘ must be entered separately. The 
program automatically gives priority to longer, entries. 
The appendix gives the complete list of phonetic codes. 
These have become something of a standard since Byte 
magazine published articles on using the votrax SC-01 
chip in fall 1981. 

SPACES AND HYPHENS 


One unique feature of the Alein System is that 
phonetic codes and English text may be freely mixed without 
changing modes. When entering phonetic codes, it is 
usually best to separate them with hyphens, e.g. "D-A-AY". 

If you want to enter a word fragment that only 
applies when it occurs at the beginning of a word then 
you should include a space immediately after the = „■ For 
suffixes, you must use the underline character instead of 
a space because Atari basic does not recognize spaces at 
the end of a line. One should use prefix definitions 
carefully since exceptions to them must also be entered 
with leading spaces. 

DO YOU REALLY WANT TO DO THIS ? 

At some point the program may query a definition. 

It does this when you are about to make an irreversible 
change. If you respond with an N the change will be 
aborted. 

ERASING AN ENTRY 


An entry can be erased by typing = followed by 
the word to be removed, e.g. =WORD 

SAVING A DICTIONARY 

After you type *D, the program will ask you to 
name the dictionary file that is to receive the data. If 
you type (for example) SWAHILI, a disk file named DSWAHILI 
will be created. Do not type a number unless you want to 
overwrite one of the existing dictionaries. When you next 
run the program, you would recall your dictionary by 
responding with SWAHILI instead of a number. 


4 



VOICE PITCH CONTROL 


i"ou can make the voice box talk in one of four 
pitch registers. At the.begining of each line of speech 
it resets itself to the next to lowest. You can shift to 
a higher register by making the first character in the 
line a slash. Two slashes will.take it to the highest 
pitch. If you want to -turn Beethoven in his grave, type: 

//DE . DE, DE. ... \\DEEEE 

This is about the limit of the musical possibilities of 
the Alien Voice Box . 

THE PHRASE MEMORIES 

This little feature was added, to save your having 
to type in the same thing twice • There are two memories 
which can each save or recall a single line of text. At 
the end of a line you want to save, add >1 or >2. At 
any other time you can recall that line by typing 1 < or 
2 < 

THE RANDOM SENTENCE GENERATOR 


After you type *R you. will be in another part of 
the program sphere new commands apply. When you first enter 
it the program will ask if you want the standard words or 
the words you saved last time . If there was no last time 
you must of course take the standard words. 

Every time you hit the return key the voice box 
will compose a new random sentence. You can get it to 
repeat the sentence by typing R . *L will return you to 
the phonetics program with the last sentence spoken saved 
in phrase memory 1. 

TO CHANGE THE WORDS USED FOR RANDOM SENTENCES 


There' are nine different types of words - nouns, 
verbs, adjectives etc. You can add to, or change the words 
in each group. If you want a particular word to have a 
greater chance of being chosen then you should enter it 
twice or more times. Note that the words in a list must be 
separated by commas, and that you are allowed only three 
lines of words. The keyboard will squawk when you get near 
the limit. 
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THE SPEED CONTROL KNOB 


This simultaneously affects the speed and pitch of 
the speech, and gives a variety of voice personalities, 
particularly when used in conjunction with the \and/ pitch 
controls. 

THE TALKING FACE 

This little extra, available onlxj in the 32K versions 
of the program is invoked by typing *F while in the phonetics 
mode. You can restore the normal full screen of text by 
typing *T at any time. 

DICTIONARY SPACE AND THE LIMIT OF MEMORY 

If you want to build up a very large vocabulary and 
you have more than 32K of RAN, you must redimension the 
two strings that hold the dictionary. Do this by altering 
the value of VXM in line 3. If you have a 48K system this 
may be as large as 11000. In that case a total of some 
20,000 bytes would be available for storing words. If, on 
the other hand, you need more memory to add features to the 
program then you can reduce VXM.. If you make it too small 
then there will be an error halt when loading a dictionary . 

The 16K disk version, (program VB), already has VXM 
set as large as possible . 

When you type *M to see how much memory has been 
used, the percentage given is referred to VXM. The function 
FRE(O) will tell you how much is left for adding basic 
statements. 

HOW TO INCORPORATE THE VOICE BOX IN YOUR OWN BASIC PROGRAM 

One way of doing this is to load either VB or VBRF, 
and build your own program around it. If you are short of 
memory you can delete lines that you don't need. An 
obvious place to start is with the menus, and vowel and 
consonant lists. 

If you won’t be saving a dictionary you can delete 
lipe 2030 and lines 4000 to 4210. If you don't need to 
see the dictionary, delete 2040 and 5000 to 5060. 

If you won't be changing the dictionary, then lines 
1015 to 1480 can go, but you should in this case ensure 
that no string to be spoken ever includes an =, as this 
will mess up the dictionary. 


6 



Atari basic sometimes goes wrong if you delete many 
lines from a program, and everything disappears. This seems 
less likely to happen if you run the program at frequent 
intervals . 

Such a stripped down version, intended to be 
incorporated in a larger program has been included on the 
disk with the name VBS. Xt is in the list form so that it 
may be merged with another program using the enter command. 
It can read a. dictionary from the disk, and pronounce words 
using it. 

The structure of the program is quite simple: 

Lines 3 to 35 load the machine code . 

Line 100 calls the subroutine at 3000 which reads 
a dictionary from disk. 

Lines>131 to 305 , (which could be omitted), remind 
you to plug in the voice box and verify that it is ready . 

It then jumps to 4000, where your program would 
normally start. Note that the actual talking is done by 
the subroutine at 1000 which speaks A $. 

This program leaves some 3700 bytes free in a 16K 
disk system .. If you need more dictionary space, and your 
program occupies less than 3700 bytes, then you should 
increase VXli in line 3 . 

ASSEMBLY LANGUAGE PROGRAMING 


For those select few who write in assembly language 
a file named VB.OBJ is included on the disk. This is a 
relocatable subroutine, (assembled at $600), which delivers 
a single byte of data to the voice box. This byte should 
be passed- in register X. On returning, all registers are 
restored, and no other locations are altered. 

It occupies 95 bytes and executes in about 2.5mS. 

If the voice box is ready for data, and up to 250mS if it 
is not. The data byte corresponds to the hexadecimal 
column in the list of phoneme codes in the appendix. 

$40, $80 or $CO should he added to ra-ise the pitch . 

Note that most phonemes will make a sound that 
persists until the next phoneme is delivered. 
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WARRANTY INFORMATION 


The Alien.Group will repair or replace any part of the 
product which fails due ,faulty materials or workmanship within 
one year from the date of purchase. All products including 
disks are thoroughly tested before leaving the factory. 

If your Voice Box should fail, send it securely packed, 
postage prepaid and insured to the Alien Group. ...A charge of 
$ 10.00 will be made to cover postage and handling . you may 
include a check or Money Order for this amount, or pay C.O.D. 
when the product is returned, It is most important when 
returning goods for repair to add a note saying precisely 
how it has failed. 

If the disk or cassette fails to load when you first try 
it, then you should within 14 days return it to the store 
for a free replacement . direct customers of the Alien Group 
may return it to us by mail within 14 days , together with a 
copy of the sales slip for a free exchange. 

Replacement disks or cassettes may be purchased by 
mail from the Alien Group for $10.00. 

In a program using animated graphics it may be 
undersirable for the action to stop while waiting for the 
voice box to finish each phoneme. In this case the calling 

program can check if new data is needed. be fore calling the 
delivery subroutine by looking at BIT 4 of &D20F. Al 
means the voice box is still busy with the last byte. 

At the beginning of the program, code $03 (-silence) should 
be delivered unconditionally. This ensures that the voice 
box is set up correctly. 
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APPENDIX - Catalogue of Disk Programs 

If you use DOS to look at the directory of files 

you will see a rather unrevealing list of cryvtonyms. 

Here is an explanation of that list. 

VB Basic program for VOICE BOX for systems with 

only 16 K. 

VBRF Basic program for VOICE BOX incorporating 

RANDOM sentences and talking FACE, for systems 
with 32K or More. 

D1 Pronunciation dictionaries. Dl is the largest 

that can be loaded by program VB 

D2 D2 spells the words out. 

D3 D3 is the largest. 

DPWORDS Default File of WORDS for random sentence 
generator 

UWORDS Users File of Words for random sentence generator. 

VB.OBJ Machine language subroutine to deliver one 
phoneme byte. 

VBS Stripped down version of basic program intended to 

be incorporated in other programs. Use the enter 
command to merge VBS with another program. 
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APPENDIX PHONEME LIST 


Phoneme 


Time 

He x- 

Phoneme 


Time , 

Hex 

Symbol 

Example 

(mS) 

Code 

Symbol 

Example 

(mS) 

Cod 

A 

DAY 

185 

20 

K 

TRICK 

80 

19 

A1 

MADE 

103 

06 

L 

LAND 

103 

18 

A2 

ENABLE 

71 

05 

M 

MAT 

103 

OC 

AE 

DAD 

185 

2 E 

N 

SUN- 

80 

OD 

AEl 

AFTER 

103 

2 F 

NG 

THING 

121 

14 

AH 

MOP 

250 

24 

0 

MORE 

185 

26 

AH1 

FATHER 

146 

15 

01 

ABOARD 

121 

35 

AH2 

HONEST 

71 

08 

02 

FOR 

80 

34 

AW 

CALL 

250 

3D 

00 

BOOK 

185 

17 

AW1 

LAWFUL 

146 

13 

OOl 

LOOKING 

103 

16 

AW2 

SALTY 

90 

30 

P_ 

PAST 

103 

25 

AY 

DAY 

65 

21 

PA0 

NO SOUND 

47 

03 

B 

BAG 

71 

0E 

PA1 

NO SOUND 

185 

3E 

CH 

CHIP 

71 

10 

R 

RED 

90 

2B 

D 

PAID 

55 

IE 

S 

PASS 

90 

IF 

DT 

BUTTER 

46 

04 

SH 

SHOP 

121 

11 

E 

MEET 

185 

2C 

STOP 

NO SOUND 

47 

3F 

El 

BE_ 

121 

3C 

T 

TAP 

71 

2A 

EH 

GET 

185 

3B 

TH 

THIN 

71 

39 

EH1 

HEAVY 

121 

02 

THV 

THE 

80 

38 

EH2 

ENLIST 

71 

01 

U 

MOVE 

185 

28 

EH 3 

JACKET 

59 

00 

U1 

YOU 

90 

37 

ER 

BIRD 

146 

3A 

VH 

CU_P 

185 

33 

F 

FAST 

103 

ID 

UH1 

UNCLE 

103 

32 

G 

GET 

71 

1C 

UH2 

ABOUT 

71 

31 

H 

HELLO 

71 

IB 

UH3 

MISSION 

47 

23 

I 

PIN 

185 

27 

V 

VAN 

71 

OF 

11 

INHIBIT 

121 

OB 

W 

WIN 

80 

2D 

12 

INHIBIT 

80 

OA 

Y 

ANY 

103 

29 

13 

INHIBIT 

55 

09 

Y1 

YARD 

80 

22 

IV 

YOU 

59 

36 

Z 

ZOO 

71 

12 

J 

JUDGE 

47 

1A 

ZH 

AZURE 

90 

07 

COMBINATIONS 







Al-AY-Y 


GAME 


UH3-AH2-U1 


HOUSE 

AH1-BH3-Y 

TIME 


Ol-Ul 


NOTE 


0H3-AH2- 

•Y 

FIGHT 


01-UH3-Y 


TOY- 


AH-1-UH3«U1 

cow 


Y1-IU-V1 


MUSIC 


J should generally be DJ and CH should be TCH 



